Dynamic Graphic Properties
When configuring dynamic images, the required dynamic graphic property must be enabled. The dynamic property describes the desired behavior of the image when given criteria are met. For instance, you may want an image to change color depending on the value of a specified data point in the underlying data. To enable a graphic property, click its switch; the property's window will open and you'll be able configure it.
Related Topics
This article covers the types of dynamic graphic properties that may be enabled. It is strongly recommended that users also review the following related topics:
-
- PQL documentation, where you can learn about the various the dynamic PQL functions in Illustrate
- How to import your own images and make them dynamic
Dynamic Properties
To construct a dynamic image, you must configure at least one of its dynamic properties. Dynamic properties are set from the image Properties panel (yellow highlight below). These properties can be used to drive the image color, show or hide the image, or drive its size, rotation, or volume.
Set the Actual Value via the Dynamic Text Editor. The Condition, Minimum, or Maximum Value can be driven by a given static value, or by a dynamic formula.
Dynamic Graphic Color Property
Available for dynamic stock and vector images only.
- Swap Color: Set the color for the outline/ borders.
- Actual Value: to set the actual value, click the plus sign, and find and select the relevant grid from the folder tree. Select the relevant cell(s).
- Below Value: set the value below which the image will show a specified color.
- Between Value: set the color that should be displayed when the value falls between the below and above values.
- Above Value: set the value above which the image will show a specified color.
Dynamic Graphic Show/Hide Property
Available for dynamic images (including stock, vector, and raster images) and texts.
- Show/Hide: determine whether the image should be shown or hidden based on the given condition.
- Actual Value: set the actual value, against which the logic will be applied.
- Condition: set the condition according to which the image will be shown or hidden.
- Condition Value: enter the condition value, against which the actual value will be compared.
Dynamic Graphic Size Property
Available for dynamic images (including stock, vector, and raster images) and texts.
- Actual Value: set the actual value, against which the logic will be applied.
- Minimum Value: set the minimum value that will drive the range against which the actual will be compared.
- Minimum Size: enter the minimum size that will be used in the size range.
- Maximum Value: set the maximum value that will drive the range against which the actual will be compared.
- Maximum Size: enter the maximum size that will be used in the size range.
Dynamic Graphic Rotation Property
Available for dynamic images (including stock, vector, and raster images) and texts.
- Actual Value: set the actual value, against which the logic will be applied.
- Rotation Direction: set the direction of the rotation.
- Minimum Value: choose the minimum value that will be used in the rotation range.
- Minimum Angle: set the smallest angle that the asset should be rotated when the minimum is reached.
- Maximum Value: choose the maximum value that will that will be used in the rotation range.
- Maximum Angle: set the largest angle that the asset should be rotated when the maximum is reached.
Dynamic Graphic Volume Property
Available for dynamic stock and vector images only.
- Actual Value: set the actual value, against which the logic will be applied.
- Minimum Value: set the minimum value that will drive the range against which the actual will be compared.
- Maximum Value: set the maximum value that will drive the range against which the actual will be compared.
- Swap Color: Set the color for the outline/ borders.
- Color: choose the color that will represent the area of coverage, or volume. This property may be disabled if the color property itself is in use.
- Counter Color: set the counter-color that will represent the area of non-coverage. This property may be disabled if the color property itself is in use.
- Minimum Volume: set the minimum volume amount. This is useful when the minimum volume should not be shown as nothing, but instead a small percentage of the range.
- Volume Direction: select the direction from which the volume color should be applied.
Static Vs Formula Values
For each dynamic property, the Actual Value is selected from the Dynamic Text Editor as a PQL or MDX formula. The Condition, Minimum, and Maximum values, however, may be a given static value, or a dynamic formula configured via the text editor.